src/mean.js

zzmq.dev@gmail.com[dev2]/mathkit[add-lcm-b-function-returns-least-common] / src / mean.js @ d0011d30 Download

Ladder Summary

file Provides a `mean` function that calculates the arithmetic average of an array of numbers, returning NaN for empty arrays or any non‑numeric or non‑finite values.

/**
 * Computes the arithmetic mean of an array of numbers.
 *
 * @param {number[]} numbers - Array of numeric values.
 * @returns {number} The mean of the numbers, or NaN for empty array or invalid inputs.
 */
export function mean(numbers) {
  if (!Array.isArray(numbers) || numbers.length === 0) return NaN;

  let sum = 0;
  for (const n of numbers) {
    if (typeof n !== "number" || !Number.isFinite(n)) return NaN;
    sum += n;
  }
  return sum / numbers.length;
}